home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / gnu / diff_2_1.lha / diff-2.1 / README.Amiga < prev    next >
Text File  |  1993-02-04  |  4KB  |  106 lines
  1.               GNU Diff, Diff3, SDiff and Cmp Version 2.1
  2.               ------------------------------------------
  3.  
  4.                      Amiga Port by Carsten Steger
  5.                      ----------------------------
  6.  
  7. Hi everyone!
  8.  
  9. In this directory you  will find the complete source code of GNU Diff.
  10. All the modifications  I had to make to get it to compile and run with
  11. SAS/C 6.2  are bracketed by  '#ifdef AMIGA' constructions. I also have
  12. included a  diff  file  (generated by diff 2.1,  of  course :-) ) that
  13. contains the context diffs to the original distribution.
  14.  
  15. Diff should  run under  any OS version with one  exception: If you use
  16. the '-l' resp.   '--paginate' flag you have to  have OS 2.0 or higher.
  17. This is due to the fact that I had to use the 'System' call to run pr.
  18. For  those of  you  that  don't have  pr: it  is  obtainable by ftp at
  19. amiga.physik.unizh.ch.  Download the file amiga-textutils-1.3.lha that
  20. comes with David Gay's brilliant port of GNU Emacs.
  21.  
  22. There's a couple of minor  differences to diff under UN*X: The current
  23. directory  is  referred to by "". So if  you want to diff a  directory
  24. <dir> against  the current directory,  type  'diff  <dir> ""'.  If you
  25. want to  change the line-  and line-group-format, here's how it's done
  26. on  the Amiga  (see  also  the sections  'Line  Formats', 'Line  Group
  27. Formats', and 'Detailed If-then-else' in the manual):
  28.  
  29. On UN*X you would type:
  30.  
  31. diff \
  32.    --old-line-format='-%l
  33. ' \
  34.    --new-line-format='|%l
  35. ' \
  36.    --unchanged-line-format=' %l
  37. ' \
  38.    old new
  39.  
  40. On the Amiga you have to type this as (type <RETURN> after each '+'):
  41.  
  42. diff "--old-line-format=-%l+
  43. " "--new-line-format=|%l+
  44. " "--unchanged-line-format= %l+
  45. " old new
  46.  
  47. Summing up: if you want to insert a newline into an argument, type '+'
  48. followed by <RETURN>.  This seems to be the only  way to do this  with
  49. the Commodore shell.
  50.  
  51. NB: The files in the '-x' resp. '--exclude'  option are specified with
  52. UN*X wildcards (as stated in the maunual): Use  '*.o'  to  get '#?.o'!
  53. (This is because the exclusion is done internally using the GNU regexp
  54. library.)
  55.  
  56. Diff3 only runs under OS  2.0  or higher. This is because I had to use
  57. the 'System' call to run the two child processes that diff3 spawns.
  58.  
  59. Sdiff, too, only runs under  OS  2.0 or  higher for the same reason as
  60. above. Please note that if you break the program with C-c or by typing
  61. the  'q' command within  sdiff, it  might take some time to  clear the
  62. pending pipe in- and output.  Otherwise the program should run exactly
  63. as described in the maual.   The  default editor  that  sdiff uses  is
  64. MEmacs  from the good old Workbench.   You should have it somewhere in
  65. your path.  Otherwise you have to set the EDITOR environment variable:
  66. setenv EDITOR <your favourite editor>.
  67.  
  68. Cmp runs under any OS version.
  69.  
  70. To  install the programs  you  just copy them to a  directory  in your
  71. path: copy c/#? <directory>
  72.  
  73. The  documentation  is included in the  diff.texi  file.  Because  not
  74. everybody has  the  texinfo package,  I  also have included  a  TeX-ed
  75. version  of the manual.  You  can  print diff.dvi  (with a TeX printer
  76. driver) to get a hardcopy of the manual.  For  those of you that don't
  77. have  TeX: An excellent  port of  TeX for the  Amiga by  Georg Hessman
  78. (PasTeX) is obtainable by ftp at ftp.uni-passau.de.
  79.  
  80. If you  have the infamous  Am*gaGuide, I highly recommend that you use
  81. MakeInfo by Sebastiano Vigna and Reinhard Spisser (on Fish disk 787 or
  82. by  ftp  at  amiga.physik.unizh.ch)  and  convert  diff.texi  into the
  83. Am*gaGuide format for online documentation.
  84.  
  85. If you use GNU  Emacs  on the  Amiga  you  might want to  install  the
  86. #?.info#?   files in  GNUEMACS:info  too.   You will  have to make  an
  87. appropriate entry in the dir file in this case.
  88.  
  89. If you  have  any  problems that you think are  specific to the  Amiga
  90. version of diff, e.g. you get a different result on the Amiga than the
  91. result you get on a  UN*X machine,  you should report them to  me.  My
  92. E-mail address is:
  93.  
  94. carsten.steger@informatik.tu-muenchen.de
  95.  
  96. If you think you have found any  other bugs, you should report them to
  97. the GNU project. Their address is:
  98.  
  99. bug-gnu-utils@prep.ai.mit.edu
  100.  
  101.  
  102.  
  103. Have fun!
  104.  
  105. Carsten
  106.